home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / time / tolleuhr / readme < prev    next >
Text File  |  1994-12-07  |  8KB  |  190 lines
  1. ************************************************************************************
  2.  
  3.     TolleUhr     Version 1.12      Authors: Matthias Fleischer 1993
  4.                                             Gunther Nikl 1994
  5.  
  6.     Note: There is a problem I cannot figure out myself. When a new minute
  7.           has to be drawn the system seems to 'hang' for a moment. This
  8.           happens with the C and assembler version. Who can help?
  9.  
  10. ************************************************************************************
  11.  
  12.  What's new this time?
  13.  
  14.  There was a bug in saveprefs() of the C version, that created additional blank
  15.  lines in the icon every time the current clock state was saved. This has been
  16.  fixed by rewriting the function. The 'Close Gadget' option has been added to the
  17.  C version of the clock. Additional code cleanups made the program even smaller.
  18.  
  19.  The assembler version offers no new features and no bug had to be fixed. Maybe
  20.  there is none :-) Some (minor) improvements were made. The program now saves the
  21.  states of currently not used values (eg. for border: hires and lace if border is
  22.  off). This is a *difference* to the C version! If the screenmode for the  used
  23.  publicscreen is changed to a mode with a smaller width, TolleUhr now lets the
  24.  system deal with that case (WA_AutoAdjust). Unless you are out of memory, TolleUhr
  25.  will be able to open its window again. Several other code changes squeezed the
  26.  program size further.
  27.  
  28.  Technical stuff: The C program should compile with every C compiler with a small
  29.                   change only (a define for the WbMsg). But note: the compiler must
  30.                   offer auto-opening of system libraries _before_ it calls _main!
  31.                   For gcc I recommend to get the proto-includes distributed with
  32.                   gcc 2.6.1 and up. Two versions are available: a plain one and an
  33.                   optimized one for 68020+ based systems.
  34.  
  35.                   The assembler version now comes also in two flavors like the C
  36.                   version. Its my first try with 68020+ instructions and I am not
  37.                   sure its worth the efforts. Anyway there is version for 'bigger'
  38.                   processors. The source for that version is supplied as a diff-file
  39.                   (means you need the 'patch' program, that's available eg. with gcc)
  40.                   You will need an assembler capable of handling 68020 instructions.
  41.                   I tested PhxAss (v3.71) and SNMA (v1.95) and both were able to
  42.                   create an executable. A68k (v2.71) is sufficient to create the
  43.                   plain version.
  44.  
  45.   Have fun!
  46.  
  47.         Gunther
  48.  
  49. ************************************************************************************
  50.  
  51.  I looked for a nice clock to use with the workbench. Then there came TolleUhr
  52.  and it was really a 'great' clock (at least for me)! But one thing I didn´t
  53.  like were these ugly menus with Kickstart 3.0. The original author  placed
  54.  this program in the public domain so here is a slightly changed  version,
  55.  nothing fundamental though.
  56.  Furthermore you can find an assembler version of 'TolleUhr'. That version is
  57.  localized (currently only german ;), has newlookmenus and  is pure, so you can
  58.  make it resident. The main difference is the fact that all windows are controlled
  59.  in the main loop. That means the second hand moves even if you display the about
  60.  requester, change a colour or set the alarm time. All windows will be discarded
  61.  if you close the main window.
  62.  One menu option has been added: 'Close Gadget'. When I played with the original
  63.  program I often closed the clock trying to move the window on the screen. With
  64.  this menu entry you can enable/disable the close gadget.
  65.  Old configurations (stored in the programs icon) can be used with the assembler
  66.  version of the clock too. The other way requires some editing in the tooltypes.
  67.  The assembler version saves PATTERN and DRAWPENS with a leading '0x' instead of
  68.  only a 'x'. Remove the zero before the x and it works or simply delete the
  69.  offending line from the icons tooltypes. That results in the default values for
  70.  these entries.
  71.  The compiled programs can be found in the 'bin' drawer. Enjoy!
  72.  
  73.    Gunther
  74.  
  75.  email: gnikl@informatik.uni-rostock.de
  76.  
  77. ************************************************************************************
  78.  
  79.  Below is the original ReadMe that came with the program:
  80.  
  81.  This is yet another Workbench-Clock-Utility ???!!?! :-(
  82.  
  83.  OK, but this one looks really nice ;-) (try it out - if you don't like it -
  84.  throw it away (or let it still stay on harddisk: only 20K anyway))
  85.  
  86.  The functionality in short:
  87.    -Nice outfit
  88.    -CLI & Workbench support
  89.    -mini-menu
  90.    -optional second hand
  91.    -custom background-pattern
  92.    -and more
  93.  
  94.  Tooltypes:
  95.  
  96.  TOP       - Number of Pixels in top of the window
  97.  LEFT      - Number of Pixels left of the window
  98.  WIDTH     - Width of the window in pixels
  99.  HEIGHT    - Height of the window in pixels
  100.  SECONDS   - 1: seconds on 0: seconds off
  101.  PATTERN   - 0000-3333
  102.  OVAL      - 1: oval face 0: rectangle
  103.  SHADOW    - 1: shadow on 0: shadow off
  104.  SHOWFACE  - 0: show minute marks 4: show no marks at all
  105.  HANDTYPE  - 0: line 1: triangle 2: rhombus 2: rectangle
  106.  HANDWIDTH - 0: very thin 4: very thick
  107.  DRAWPENS  - 00000000000000-33333333333333
  108.  BORDERTYPE- 0 no border 5 full border
  109.  CHIME     - 0 no chime 4 full functioning chime
  110.  PUBSCREEN - Name of public screen
  111.  TASKPRI   - Priority of the clock-task (_should_ be between -5 and 5)
  112.  
  113.  The background-pattern:
  114.  
  115.  It is set by a decimal number of 4 digits (abcd) and gives a background-
  116.  pattern that looks like this:
  117.  
  118.   abababababab  For example: 0110 gives dark grey
  119.   cdcdcdcdcdcd               0220 gives light grey
  120.   abababababab               0123 looks a bit like jeans-style
  121.   cdcdcdcdcdcd
  122.  
  123.  numbers greater than nine are set as: xaabbccdd (hex)
  124.  
  125.  The drawpens:
  126.  
  127.  abcdefghijklmn
  128.  a color for second hand
  129.  b color for minute hand
  130.  c color for minute hand outline
  131.  d color for hour hand
  132.  e color for hour hand outline
  133.  f color for shadow
  134.  g color for 12'o clock mark
  135.  h color for quarters
  136.  i color for hour marks
  137.  j color for minute marks
  138.  k border color 0
  139.  l border color 1
  140.  m border color 2
  141.  n border color 3
  142.  
  143.  You also can use xaabbccddeeffgghhiijjkkllmmnn.
  144.  
  145.  CLI-commands:
  146.  
  147.  TOP/N,LEFT/N,WIDTH/N,HEIGHT/N,SECONDS/S,PATTERN/K,OVAL/S,SHADOW/S,
  148.  SHOWFACE/N,HANDTYPE/N,HANDWIDTH/N,DRAWPENS/K,BORDERTYPE/N,CHIME/N,
  149.  PUBSCREEN/K,TASKPRI/N:
  150.  
  151.  -all the same.
  152.  
  153.  Menus:
  154.  
  155.  You can set anything but pubscreens and taskpriority from menus and save it to
  156.  the tooltypes field with the `Save prefs' menu.
  157.  There's also an alarm-function from menus.
  158.  
  159.  Gadgets:
  160.  
  161.  There is a invisible close-gadget in the upper left corner of the window,
  162.  a (also invisible) depth-gadget in the upper right, a sizing-gadget in the
  163.  lower right corner and a drag-gadget in the middle of the window.
  164.  
  165.  The legal stuff:
  166.  If you use this program, you use it at your own risk - there is absolutely
  167.  no warranty for any damage forced by this program (and by no means for wild
  168.  attacks of envious non-amiga-users).
  169.  This program is public-domain, that means you can copy, modify or use it as
  170.  long as you wish and you needn't pay anything.
  171.  But: It must be absolutely clear at any time if and by what person this
  172.       program was modified - there must be a FULL list of ALL the authors
  173.       who made ANYTHING about this program at least in the source code
  174.       and also in any about-requesters.
  175.  (I don't want to be blamed of any errors somebody else made than me.)
  176.  
  177.  That was all - for bug reports please write to me:
  178.  
  179.  Matthias Fleischer
  180.  Adlerstraße 30
  181.  F.R.Germany
  182.  73760 Ostfildern 2
  183.  Phone: 0711/3430286
  184.  email: fleischr@izfm.uni-stuttgart.de
  185.  
  186.  and don't ask me for any enhancements - I won't do them anyway.
  187.  
  188.  
  189.  PS: Please excuse my poor english - I'm not trained very good in that.
  190.